{% extends "howto" %}

{% block content %}
<h2 id="storages">Stockages</h2>

<p>Les <em>Stockages</em> (Storages) sont des Outils spécialisés.
Ils construisent et retournent des instances d'objets stockés dans des fichiers du kit.</p>

<p>Ils s'utilisent comme des Outils standards, en tant que membre de leur kit parent.
Par example, récupérons un gabarit depuis le stockage nommé <em>templates</em> d'un kit :</p>

<code>// definition des criteres de recherche
<var>$criteria</var>=array('id'=>'help','lang'=>'fr');

// obtention de l'instance correspondante
<var>$tpl</var>=<var>$kit</var>->templates->getItem($criteria);

// utilisation de l'instance
echo <var>$tpl</var>->render($data);</code>

<h3>Le mécanisme</h3>

<p>Un masque de recherche est défini dans le fichier de configuration du Stockage.
Il s'agit d'un chemin relatif (à la racine du kit) vers le fichier dont les éléments entre double accolades seront interprétés comme des variables. Par exemple :</p>
<code>[storage]
<var>search</var> = "templates/&#123;{lang}}/&#123;{id}}.html"</code>
<p>Ici si <var>lang</var>="fr" et <var>id</var>="help" le fichier source du gabarit sera templates/fr/help.html</p>
{% endblock %}
